home *** CD-ROM | disk | FTP | other *** search
Text File | 1998-09-01 | 9.0 KB | 222 lines | [TEXT/CWIE] |
- ========================================================================
- Metrowerks Class Wrangler Release Notes
- ========================================================================
-
- Version: 1.4
- Date: 9-1-98
- Author: Greg Bolsinga, Peter Lewis, Tim Freehill
- ========================================================================
-
- Class Wrangler will allow you to view and create .zip files which are
- in a non-compressed zip format or compressed using the deflate
- algorithm. This is the same algorithm used in the zlib library as well
- as JDK 1.1's JAR files.
-
- Class Wrangler IS NOT a general purpose utility for zip compressed
- files. It will only handle zip files which are all contained in one file
- (no disk-spanning files). It can also only handle zip files compressed
- with the deflate algorithm used in JDK 1.1 JAR files. It doesn't handle
- encrypted zip files.
-
- Please note that Class Wrangler checks for duplicate items in the zip
- file or the destination only by looking at the item's fully qualified
- name. This was chosen since pathnames must be unique in Java. It doesn't
- compare the item's contents.
-
-
- ========================================================================
- Released Versions
- ========================================================================
- 1.0.0b1 CW10
- 1.0 Discover Programming with Java (Rev 2)
- 1.0.1 CW11
- 1.1 CWPro1
- 1.2 CWPro2
- 1.3 CWPro3
- 1.4 CWPro4
-
-
- ========================================================================
- New Features since CWPro3
- ========================================================================
-
- * Add text viewer window. It allows viewing of any file that Internet
- Config indicates is a text file. It uses the file's extension to
- figure that out. Double clicks / enter key will View text files.
-
- * Add class disassembly window. It's the same disassembler used in the
- IDE.
-
- * Remove the file filtering preferences. They aren't necessary anymore.
- Open will show all zip files. Add will show all files.
-
- * Add user selected color preferences for all the items that are drawn
- specially in Class Wrangler.
-
- * Add 'Find Main Classes' command to the Package menu. This will find
- all classes in an archive that have a main method. These are java
- application classes that can be invoked from the command line.
-
-
- ========================================================================
- Bugs Fixed since CWPro3
- ========================================================================
-
- * Fix an crasher that could occur if two open documents have the same
- name. This is an old bug.
-
- 1.4fc1:
-
- * Fix a table bug that manifested itself when dragging a top level
- directory to another window's top level position. If any of the items
- dragged didn't define their position, they would 'float' to the top
- level.
-
- 1.4b4:
-
- * Fix a bug when saving the manifest as text. It would leak memory, and
- leave a file in the MacOS temp folder, which wouldn't close, and would
- then show up in the trash as rescued the next time you started MacOS.
- This could also cause a crash if the user attempted to save a modified
- zip file after saving the manifest as text. (MW08808)
-
- * Fix a very simliar bug to the above when modifying an archive file
- that has been compared by Class Wrangler.
-
- 1.4b3:
-
- * Text Copy of directories and outer classes now only copies the
- directory or the outer class, instead of everything inside as well.
- (Since 1.0) (MW08641)
-
- 1.4b2:
-
- * Fix the tabs in the text window. Make the text window display in
- Monaco 9 monospaced. (Since 1.4b1)
-
- * Fix a bug where certain strings would be displayed incorrectly in the
- java disassembler. This bug was also in the java linker in the IDE.
- (Since 1.0)
-
- * Fix bugs in the Information window and the java disassembler if a name
- was longer than 255 characters. The length no longer matters. This bug
- was also in the java linker in the IDE. (Since 1.0)
-
- * If an item was moved that was originally in a zip file, it wouldn't be
- saved in its new position, only the old position. Now it will be saved
- correctly. (MW07155)
-
- 1.4b1:
-
- * The text shown in the Edit menu for Undo was usually incorrect. Now it
- ought to be correct.
-
- * Fix a bug if a 'bad' file was opened from the dialog that asks the
- user to open a file at startup. It would report errors with 2 dialog
- boxes. It will only inform about the error once now.
-
- * Class Wrangler will now properly indicate when it has run out of
- memory. Occasionally, it would not tell the user about the error.
-
- * If an archive file is opened that has bad manifest data, Class
- Wrangler will now tell the user, and still open the archive. The
- archive is then marked dirty. Previously, Class Wrangler would always
- tell the user that it had run out of memory in this circumstance.
-
- * If a 'fake' java class is added to an archive, Class Wrangler wouldn't
- add it, and wouldn't tell the user it didn't add it. It now informs
- the user that the fake class files aren't added. A fake java class
- file is a file that ends in ".class", but doesn't have the java class
- magic number at the start of the file.
-
- * Fix an annoying selection bug. This manifested itself in strange ways.
- If a selected item was expanded, the selection would get messed up.
- Or, if a directory was created, and movable items were dragged into
- it, they would not be in that directory after a save. (Since 1.2)
-
-
- ========================================================================
- Known Bugs and Incompatibilities
- ========================================================================
-
- * Class Wrangler doesn't correctly parse manifest files that have global
- manifest data, such as manifest files in JDK 1.2 that contain the
- Main-Class, Class-Path, & Archive-Sealed tags. It only handles
- manifest tags that are associated with a particular item. Other new
- JDK 1.2 tags will be in the item's 'Other' pane in the manifest
- editing window. Support for these global tags will be in the next
- version of Class Wrangler. In this version & previous versions, global
- manifest tags are lost.
-
- * It's legal for a java source file to have no public classes/
- interfaces. If this is true for an source file to be added, Class
- Wrangler gets the package name, and uses the given name of the added
- source file if there is more than one class/interface in the file. If
- there is only one non-public class/interface, it's name is used. It's
- also legal to have a source file that has more than one public class/
- interface. In this case, Class Wrangler uses the first public class/
- interface as the correct source file name. Class Wrangler will prompt
- first in these cases, always using the package name if it can
- determine it.
-
- * If MacOS8, option drags to the Finder will sometimes cause the Finder
- to start copying what's dragged to it. I don't know where this bug is
- yet.
-
- * When opening a archive file that has class files in the incorrect
- position, according to their package, Class Wrangler leaves them in
- the incorrect position. Class Wrangler considers the layout hierarchy
- of the archive to be correct when it opens it.
-
- * When adding a Mac file to Class Wrangler that has both a data fork and
- a resource fork, the resource fork is ignored. The resource fork isn't
- used by java, so it was decided to pass on it. Files with only
- resource forks can be added to Class Wrangler (it'll ask if you really
- want to), but will have no data. If Class Wrangler had this ability,
- it would be a general purpose archive tool. If this is something you
- think would be handy, we need to know the best way to append resource
- forks. Resource forks for text files or class files shouldn't be
- appended, since they won't make any sense cross-platform, etc. It
- could be a preference. What format should the data/resource fork data
- take in the zip file? Please respond to the email address below.
-
- * Preferences from versions prior to 1.2 are not kept when using a newer
- version.
-
- * Holding down the option key while the Java Info window is in the front
- and and nothing is selected will show a disabled 'Copy Java'.
-
-
- ========================================================================
- Additional Notes
- ========================================================================
-
- Future features will include:
- - Undo in the Manifest editing document.
- - UI for JDK 1.2 manifest tags.
- - Mass Beanosity changing.
- - Type-ahead in java information window lists.
- - Sorting zip files by name, size, etc.
- - Scriptability.
- - Printing.
-
-
- ========================================================================
- Contacting Metrowerks
- ========================================================================
-
- For bug reports, technical questions, and suggestions, please use the
- forms in the Release Notes folder on the CD, and send them to
-
- support@metrowerks.com
-
- See the CodeWarrior on the Nets document in the Release Notes folder for
- more contact information, including a list of Internet newsgroups,
- online services, and patch and update sites.
-
-
- ========================================================================
-
- Greg Bolsinga
- Metrowerks Corporation
-